Skip to content

engine: configure registry push/pull with containerd#24213

Open
dvdksn wants to merge 2 commits intodocker:mainfrom
dvdksn:disable-push-registry
Open

engine: configure registry push/pull with containerd#24213
dvdksn wants to merge 2 commits intodocker:mainfrom
dvdksn:disable-push-registry

Conversation

@dvdksn
Copy link
Copy Markdown
Contributor

@dvdksn dvdksn commented Feb 25, 2026

Signed-off-by: David Karlsson 35727626+dvdksn@users.noreply.github.com

@netlify
Copy link
Copy Markdown

netlify bot commented Feb 25, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit c3c4f9e
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69dcb2dd6abb82000838b0ca
😎 Deploy Preview https://deploy-preview-24213--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added the area/engine Issue affects Docker engine/daemon label Feb 25, 2026
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
@dvdksn dvdksn force-pushed the disable-push-registry branch from 49a658a to 0ed696e Compare February 26, 2026 12:35
@dvdksn dvdksn marked this pull request as ready for review February 26, 2026 12:35
Copy link
Copy Markdown
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

This is a well-written documentation page that clearly explains how to configure per-registry behavior using hosts.toml files with the containerd image store.

Strengths:

  • Clear structure with progressive examples (disable push → mirror → internal-only)
  • Proper front matter with all required fields
  • Accurate technical content with correct file paths and TOML syntax
  • Good use of tables for reference information
  • Appropriate callout explaining security limitations
  • Helpful section explaining interaction with daemon.json settings
  • Links to related documentation are valid

No issues found. The page follows Docker's documentation style guide and provides users with the information they need to configure registry access.

Comment thread content/manuals/engine/daemon/configure-registry.md Outdated
Comment thread content/manuals/engine/daemon/configure-registry.md Outdated
Comment thread content/manuals/engine/daemon/configure-registry.md Outdated
Comment thread content/manuals/engine/daemon/configure-registry.md Outdated
Comment thread content/manuals/engine/daemon/configure-registry.md Outdated
Comment thread content/manuals/engine/daemon/configure-registry.md
@dmcgowan
Copy link
Copy Markdown
Contributor

Sorry our docs can be a bit confusing and the use of it with "default" and "host" is a bit hard to follow. The idea was that the simple cases would just be updating defaults and possibly adding some mirrors. The amount of "features" that could be support via different permutations is part of the design, but not done in the easiest follow way. Parts of this are mentioned in https://github.com/containerd/containerd/blob/main/docs/hosts.md though.

@dvdksn dvdksn requested a review from dmcgowan April 13, 2026 09:03
Address review feedback from dmcgowan:
- Fix "disable push" example to use top-level capabilities field instead
  of a [host] entry (the [host] section is for mirrors, not the default endpoint)
- Fix mirror example to remove redundant [host] entry for the upstream
  registry; server already handles fallback
- Replace "internal registry only" example with a simpler correct approach:
  set server to the internal registry URL, no [host] entries needed
- Add Windows directory name format for registries with ports
- Add _default/ directory to the tree and explain its use as a global fallback
- Clarify format section: top-level fields vs [host] sections, and that
  capabilities defaults to all three if not set

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
@dvdksn dvdksn force-pushed the disable-push-registry branch from b9466d6 to c3c4f9e Compare April 13, 2026 09:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/engine Issue affects Docker engine/daemon

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants